home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_MAN / EXP_VRML.MAN < prev    next >
Encoding:
Text File  |  1996-07-27  |  5.5 KB  |  131 lines
  1.  
  2.  
  3. Export-VRML()              Unix Programmer's Manual              Export-VRML()
  4.  
  5.  
  6. NAME
  7.      exp_vrml - VRML geometry export filter
  8.  
  9. SYNOPSIS
  10.  
  11.      This man page describes the options specific to the VRML geometry  export
  12.      converter.
  13.  
  14. EXAMPLE CONVERSION SYNTAX
  15.  
  16.      To convert a 3D Studio file to VRML using the default  parameters  listed
  17.      in the setup.ini file:
  18.  
  19.           pt -i 3ds -o vrml filename.3ds
  20.  
  21.      To convert a Lightwave file to VRML and  override  some  of  the  default
  22.      options in setup.ini:
  23.  
  24.           pt -i lw -o vrml -out-output-texture-data = yes filename.lw
  25.  
  26. OVERVIEW
  27.  
  28.      VRML is an ASCII file format for describing 3d scenes  which  is  primary
  29.      used  in  interactive  virtual  reality  applications. This VRML geometry
  30.      export converter writes out the scene database to a VRML  v1.0  compliant
  31.      file.
  32.  
  33.      Concave polygons and polygons with  holes  will  be  triangulated  before
  34.      being  output as indexed polygon primitives. Cameras, lights and material
  35.      definitions will also be output in addition to the basic geometry.  Since
  36.      there  is  no  ambient  light  type in the VRML specification the ambient
  37.      light color is multiplied into each material's ambient color.
  38.  
  39.      Normals and texture coordinates are bound on a  per-vertex  basis,  while
  40.      materials  are  bound  on  a  per-face  (per-polygon)  basis. If multiple
  41.      textures are assigned to  a  single  object  then  that  object  will  be
  42.      exploded  into separate indexed polygon primitives before being output to
  43.      the VRML file, with each primitive being assigned a single texture.
  44.  
  45.      Note that this converter does not allow anchors or inlines to  be  output
  46.      along  with  the  data.  These  commands  can  be  inserted into the file
  47.      manually.
  48.  
  49.      As with all other export converters, the exported  indexed  polygons  are
  50.      automatically  welded and optimized before being output to the VRML file.
  51.      This  optimization  step  includes  removing  redundant  coordinates  and
  52.      creating vertex normals if none exist. Thus, the exported geometry should
  53.      be in a good, compact form for efficient VRML usage.
  54.  
  55. COMMAND LINE OPTIONS
  56.  
  57.      The following options are specific to this export converter:
  58.  
  59.      -o vrml
  60.           This is the mandatory command line option which specifies  that  the
  61.           data is to be exported using the VRML format converter.
  62.  
  63.  
  64.                                                                              1
  65.  
  66.  
  67.  
  68. Export-VRML()              Unix Programmer's Manual              Export-VRML()
  69.  
  70.  
  71.      -out-vrml-file-version = [ 1 | 2 ]
  72.           This selects what VRML file format to save the data into.  '1'  will
  73.           output  in  the  original VRML 1.0 format whereas '2' will output in
  74.           the new 'Moving Worlds' format.
  75.  
  76.      -out-vrml-embed_texture_images = [ yes | no ]
  77.           If this option is set to 'yes'  and  the  '-out-output-texture-data'
  78.           option  is  set  to  'yes' then any texture images referenced by the
  79.           VRML data will be embedded directly within the file.  The  converter
  80.           can  convert  and embed the following file formats (and all of their
  81.           variations): BMP, FLIC, GIF, CEL (Autodesk), JPEG, Targa and TIFF.
  82.  
  83.      -out-vrml-output-texture-data = [ yes | no ]
  84.           If this option is set to 'yes' then texture mapping coordinates  and
  85.           references  will  be  output  to  the VRML file for those primitives
  86.           which references 2d textures. If set to 'no' then no texture mapping
  87.           related information will be output.
  88.  
  89.      -out-vrml-add-url-prefix = [ yes | no ]
  90.           If this option is set to 'yes' then all bitmap  filenames  (used  in
  91.           association  with  a  texture  map) will be prefixed with the string
  92.           specified by the '-out-vrml-url-string' option below.  For  example,
  93.           if a texture references the filename 'c:/nugraf/textures/bitmap.tif'
  94.           within the NuGraf database, and the URL is specified on this  dialog
  95.           box  as "http://www.okino.com/images/" then the bitmap filename will
  96.           be       stored       in       the        VRML        file        as
  97.           'http://www.okino.com/images/bitmap.tif'.
  98.  
  99.      -out-vrml-url-string = "URL string goes here"
  100.           This is the URL string that  will  be  prefixed  before  any  bitmap
  101.           filenames  in the VRML file. You must enable the '-out-vrml-add-url-
  102.           prefix' option above for this string to take affect.
  103.  
  104.      -out-line-ending = [ cr | lf | crlf ]
  105.           This common option selects which line terminator is to be  used  for
  106.           the ASCII output file. Files destined for DOS/PC machines should use
  107.           'crlf', files for UNIX  machines  should  use  'lf'  and  files  for
  108.           Macintosh  machines  should  use  'cr'.   The default is specific to
  109.           which machine this converter is presently  running  on:  'crlf'  for
  110.           DOS/PC,  'lf'  for UNIX and 'cr' for Macintosh. This option normally
  111.           does not have to be specified unless you will be using the  exported
  112.           ASCII file on a different type of computer.
  113.  
  114. VRML SITES ON THE INTERNET
  115.  
  116.      http://www.vrml.org
  117.           Home site of VRML organization.
  118.  
  119.      http://www.sdsc.edu/vrml
  120.           Virtual Reality Modeling Language Repository.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                              2
  130.  
  131.